﻿<html DIR="LTR" xmlns:tool="http://www.microsoft.com/tooltip" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:ddue="http://ddue.schemas.microsoft.com/authoring/2003/5" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
  <head>
    <META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=utf-8" />
    <META NAME="save" CONTENT="history" />
    <title>SQLServerDriverForPHP_Readme</title>
    
    
    
    <style TYPE="text/css">
body
{
background: #FFFFFF;
color: #000000;
font-family:    Verdana;
font-size: medium;
font-style: normal;
font-weight: normal;
margin-top: 0;
margin-bottom:  0;
margin-left:    0;
margin-right:   0;
width:  100%;
}

div.#mainSection
{
font-size: 70%;
width: 100%;
padding-left:    10;
margin-right: 10;
}

div.#mainBody
{
font-size: 90%;
margin-top: 10;
padding-bottom: 20;
}

div.#header
{
background-color: #D2D2D2;
padding-top:    0;
padding-bottom: 0;
padding-left:   10;
padding-right:  0;
width:          100%;
}

div.#header table
{
border-bottom-color: #C8CDDE;
border-bottom-style: solid;
border-bottom-width: 1;
width:  100%;
}

span.#runningHeaderText
{
color: #003399;
font-size: 90%;
}

span.#nsrTitle
{
/*    color: #003399;*/
font-size: 120%;
font-weight: 600;
}

div.#header table td
{
color: #000000;
font-size: 70%;
margin-top: 0;
margin-bottom:  0;
padding-right: 20;
}

div.#header table tr.#headerTableRow3 td
{
padding-bottom: 2;
padding-top: 5;
}

div.#header table.#bottomTable
{
border-top-color: #FFFFFF;
border-top-style: solid;
border-top-width: 1;
text-align: left;
}

div.#footer
{
font-size: 90%;
margin-top: 0;
margin-bottom:  0;
margin-left:    -5;
margin-right:   0;
padding-top:    2;
padding-bottom: 2;
padding-left:   0;
padding-right:  0;
width:  100%;
}

hr.#footerHR
{
border-bottom-color: #EEEEFF;
border-bottom-style: solid;
border-bottom-width: 1;
border-top-color: C8CDDE;
border-top-style: solid;
border-top-width: 1;
height: 3;
color: #D2D2D2;
}

div.section
{
padding-top:    2;
padding-bottom: 2;
padding-right:  15;
width:  100%;
}

.heading
{
color:          #000000;
font-weight:    bold;
margin-top:     18;
margin-bottom:  8;
}

h1.heading
{
color: #000000;
font-size:  150%;
}

.subHeading
{
color:          #000000;
font-weight:    bold;
font-size:      150%;
margin-bottom:  4;
}

h2.subHeading
{
color:          #000000;
font-weight:    bold;
font-size:      130%;
}
h3.subHeading
{
color:  #000000;
font-size: 125%;
font-weight: bold;
}

h4.subHeading
{
color: #000000;
font-size: 110%;
font-weight: bold;
}

h4.procedureHeading
{
color: #000080;
font-size: 110%;
font-weight: bold;
}

h5.subHeading
{
color: #000000;
font-size: 100%;
font-weight: bold;
}

img
{
padding-bottom: 10;
}

img.toggle
{
border: 0;
margin-right: 5;
padding-bottom: 10;
}

img.copyCodeImage
{
border: 0;
margin: 1;
margin-right: 3;
padding-bottom: 10;
}

img.downloadCodeImage
{
border: 0;
margin-right: 3;
padding-bottom: 10;
}

img.viewCodeImage
{
border: 0;
margin-right: 3;
padding-bottom: 10;
}

img.note
{
border: 0;
margin-right: 3;
padding-bottom: 10;
}

img.#membersOptionsFilterImage
{
border: 0;
margin-left: 10;
vertical-align: middle;
padding-bottom: 10;
}

img.#toggleAllImage
{
margin-left: 4;
vertical-align: middle;
padding-bottom: 10;
}

div.#mainSection table
{
border: 0;
font-size: 100%;
width:  100%;
margin-top: 5px;
margin-bottom: 15px;
}

div.#mainSection table tr
{
vertical-align: top;
}

div.#mainSection table th
{
text-align: left;
background: #D8D8D8;
border-bottom-color: #D8D8D8;
border-bottom-style: solid;
border-bottom-width: 1;
color: #000000;
padding-left: 5;
padding-right: 5;
}

div.#mainSection table td
{
background: #F2F2F2;
border-top-color: #D8D8D8;
border-top-style: solid;
border-top-width: 1;
padding-left: 5;
padding-right: 5;
}

div.#mainSection table td.imageCell
{
white-space: nowrap;
}

div.code
{
width: 98%;
}

div.code table
{
border: 0;
font-size: 95%;
margin-bottom: 5;
width: 100%
}

div.code table th
{
text-align: left;
background: #D8D8D8;
border-bottom-color: #D8D8D8;
border-bottom-style: solid;
border-bottom-width: 1;
color: #000000;
font-weight: bold;
padding-left: 5;
padding-right: 5;
}

div.code table td
{
background: #CCCCCC;
border-top-color: #D8D8D8;
border-top-style: solid;
border-top-width: 1;
padding-left: 5;
padding-right: 5;
padding-top: 5;
}

div.alert
{
margin-left: 10;
width: 98%;
}

div.alert table
{
border: 1;
font-size: 100%;
width:  100%;
border: solid 1 #DEDFEF;
}

div.alert table th
{
text-align: left;
background: #D8D8D8;
border-bottom-width: 0;
color: #000000;
padding-left: 5;
padding-right: 5;
border: solid 1 #DEDFEF;
}

div.alert table td
{
background: #FFFFFF;
border-top-color: #D8D8D8;
border-top-style: solid;
border-top-width: 1;
padding-left: 5;
padding-right: 5;
border: solid 1 #DEDFEF;
}

span.copyCode
{
color: #0000ff;
font-size: 90%;
font-weight: normal;
cursor: hand;
float: right;
display: inline;
text-align: right;
}

.downloadCode
{
color: #0000ff;
font-size: 90%;
font-weight: normal;
cursor: hand;
}

.viewCode
{
color: #0000ff;
font-size: 90%;
font-weight: normal;
cursor: hand;
}

div.code pre
{
font-family:    Monospace, Courier New, Courier;
font-size: 105%;
color:  #000000;
}

code
{
font-family:    Monospace, Courier New, Courier;
font-size: 105%;
color:  #000000;
}

dl
{
margin-top: 0;
padding-left:   1;
}

dd
{
margin-bottom:  0;
margin-left:    0;
padding-left:   20;
}

dd p
{
margin-top: 5;
}

ul
{
margin-left: 17;
list-style-type: disc;
}

ul ul
{
margin-bottom: 4;
margin-left: 17;
margin-top: 3;
list-style-type: disc;
}

ol
{
margin-left: 24;
list-style-type: decimal;
}

ol ol
{
margin-left: 24;
margin-top: 3;
list-style-type: lower-alpha;
}

li
{
margin-top: 0;
margin-bottom: 0;
padding-bottom: 0;
padding-top: 0;
margin-left: 5;
}

p
{
margin-bottom: 15;
}

.tip
{
color:  #0000FF;
font-style: italic;
cursor:hand;
text-decoration:underline;
}

.math
{
font-family: Times New Roman;
font-size: 125%
}
.sourceCodeList
{
font-family: Verdana;
font-size: 90%;
}

pre.viewCode
{
width: 100%;
overflow: auto;
}

li:hover table, li.over table
{
background-color: #C0C0C0;
}

li:hover ul, li.over ul
{
background-color: #d2d2d2;
border: 1px solid #000;
display: block;
}
            </style>
  </head>
  <body>
    <!--Topic built:04/23/2009 21:02:04-->

    
    
    
    
    
    
    
    
    
    <div id="header">
      <table width="100%" id="topTable"><tr>
          <td align="left">
            <span id="nsrTitle">SQLServerDriverForPHP_Readme</span>
          </td>
          <td align="right">
            <span id="headfb" class="feedbackhead">
            </span>
          </td>
        </tr></table>
      
      
      
    </div>
    <div id="mainSection">
      <div id="mainBody"><p> 04/23/2009 21:02:04</p>
        
        <font color="DarkGray"> </font><p /> 
        <span id="changeHistory">
        </span>
    <p>This document contains late-breaking information and other important information that supplements the Microsoft SQL Server Driver for PHP documentation. You should read this file completely before you install the SQL Server Driver for PHP.</p>
    <p>For the latest SQL Server Driver for PHP documentation, see <a href="http://go.microsoft.com/fwlink/?LinkID=119889" alt=""><linkText xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">the MSDN online documentation</linkText></a>.</p>
  <h1 class="heading">Installation</h1><div id="sectionSection0" class="section"><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
      <p xmlns="">When you unpack the downloaded files for this release, you will find the php_sqlsrv_ts.dll and php_sqlsrv.dll files. These files correspond to a thread-safe version and a non–thread-safe version (respectively) of the SQL Server Driver for PHP. Follow the installation instructions in the "Loading the Driver" topic in the documentation to install the driver.</p>
      <p xmlns="">
        <b>Note</b>: The php_sqlsrv_ts.dll file is compatible with php5ts.dll, and php_sqlsrv.dll is compatible with php5.dll.</p>
    </content></div><h1 class="heading">Updates</h1><div id="sectionSection1" class="section"><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
      <p xmlns="">The following updates are included in this release of the SQL Server Driver for PHP:</p>
      <ul xmlns=""><li>
          The name of the driver is now SQL Server Driver for PHP. The previous name, SQL Server 2005 Driver for PHP, led many people to infer that the driver was only compatible with SQL Server 2005, although it is also compatible with SQL Server 2008. Note, however, that regardless of which version of SQL Server you are targeting, you must have SQL Server 2005 Native Client installed on the same machine that is running PHP. For more information about SQL Server 2005 Native Client, see the <a href="http://go.microsoft.com/fwlink/?LinkId=101877" alt=""><linkText xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">Microsoft SQL Server Native Client</linkText></a> page on MSDN. To download and install the SQL Server 2005 Native Client now, click on the appropriate link below:<br />
          <ul><li>
              
                <a href="http://go.microsoft.com/fwlink/?LinkId=137108" alt=""><linkText xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">Download the X86 package</linkText></a>
              <br />
            </li><li>
              
                <a href="http://go.microsoft.com/fwlink/?LinkId=137109" alt=""><linkText xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">Download the X64 package</linkText></a>
              <br />
            </li><li>
              
                <a href="http://go.microsoft.com/fwlink/?LinkId=137110" alt=""><linkText xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">Download the IA64 package</linkText></a>
              <br />
            </li></ul>
        </li><li>
          Variables passed as query parameters to the <b>sqlsrv_prepare</b> function in the parameter array should be passed by reference instead of by value. If you pass query parameters by value to <b>sqlsrv_prepare</b>, other variables that are assigned to the query parameters might be overwritten when the query is executed. To call attention to this, a PHP warning will now be raised when a query with by-value parameters is executed. For more information, see <b>sqlsrv_prepare</b> in the API Reference section of the product documentation.<br />
        </li><li>
          Variables passed as query parameters to the <b>sqlsrv_query</b> function in the parameter array can be passed by value without concern for overwriting other variables that are assigned to the query parameters.<br />
        </li><li>
          The log message "Failed to remove statement resource" is no longer written to the log file when no failure occurred.<br />
        </li><li>
          Calling a stored procedure with a RETURN clause no longer causes an error.<br />
        </li><li>
          Binding a string output parameter to a PHP variable that has been set to <b>null</b> no longer fails.<br />
        </li><li>
	  Executing a query in which a string output parameter is bound to a PHP variable that has been set to <b>null</b> no longer causes an error.
	</li><li>
          In previous releases, calling a stored procedure that returned an output parameter of type <b>string</b> caused a truncation error. This issue has been fixed.<br />
        </li></ul>
    </content></div><h1 class="heading">Known Issues</h1><div id="sectionSection2" class="section"><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
      <p xmlns="">There are no known issues with this release of the SQL Server Driver for PHP.</p>
    </content></div><h1 class="heading">Support</h1><div id="sectionSection3" class="section"><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
      <p xmlns="">For support questions related to the SQL Server Driver for PHP, contact Microsoft Help and Support. For more information, see <a href="http://go.microsoft.com/fwlink/?LinkId=122302" alt=""><linkText xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">How and when to contact Microsoft Customer Service and Support</linkText></a>. Configurations of the following components are supported:</p>
      <ul xmlns=""><li>
          Operating systems: All editions (in 32-bit and 64-bit versions) of Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP.<br />
        </li><li>
          SQL Server: All editions of SQL Server 2008 and SQL Server 2005.<br />
          <div class="alert"><table width="100%" cellspacing="0" cellpadding="0"><tr><th align="left">Note: </th></tr><tr><td>
            The SQL Server Driver for PHP handles the new SQL Server 2008 data types as their SQL Server 2005 equivalents.<p />
          </td></tr></table><p /></div>
        </li><li>
          SQL Server Native Client 9.0: The SQL Server 2005 ODBC driver.<br />
        </li><li>
          PHP: Versions 5.2.4 through 5.2.9 of the PHP runtime.<br />
        </li></ul>
    </content></div><h1 class="heading">Source Code Availability</h1><div id="sectionSection4" class="section"><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
      <p xmlns="">The source code for the SQL Server Driver for PHP is available <a href="http://go.microsoft.com/fwlink/?LinkId=123025" alt=""><linkText xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">here</linkText></a>.</p>
      <div class="alert" xmlns=""><table width="100%" cellspacing="0" cellpadding="0"><tr><th align="left">Note: </th></tr><tr><td>
        Only the version of the driver released by Microsoft is supported by Microsoft Customer Service and Support.<p />
      </td></tr></table><p /></div>
    </content></div><h1 class="heading">See Also</h1><div id="seeAlsoSection" class="section" name="collapseableSection"><h4 class="subHeading">Other Resources</h4><a href="http://go.microsoft.com/fwlink/?LinkID=119889" alt=""><linkText xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">SQL Server</linkText></a><br /><br />
		<h4 class="subHeading">
			
		</h4>
		<b>
			
			
		</b>
	</div><!--[if gte IE 5]>
			<tool:tip element="seeAlsoToolTip" avoidmouse="false"/><tool:tip element="languageFilterToolTip" avoidmouse="false"/><tool:tip element="roleInfoSpan" avoidmouse="false"/>
		<![endif]--></div>
      <div id="footer">
			
			© 2008-2009 Microsoft Corporation. All rights reserved.
		</div>
    </div>
  </body>
</html>